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GETTING STARTED 

A PC/PILOT program is made up gf a series of 
commands or statements. There are only about 
twenty different kinds of statements. Each one 
has a specific purpose. A statement is always 
written on one line of the screen when writing. 
the program, Each statement starts with a letter 
called an op code; the op code identifies the 
particular.type of statement. After the oo code 
‘there is a colon (:), and after the colon there 
may be some text. - = 


_ _The normal way to write a program is to use a 


text editor to create a disk file. The disk file 
consists of the statements that make up the 


program. Once the disk file is created you can _ 


tell PC/PILOT to run the program. We will talk 


more later about the process of creating the - 


program file on disk. 


To get started we will run an already written 


_ PC/PILOT program called SAMPLE1 which is 
supplied on your PC/PILOT disk. It will allow us 
to try out one statement at a time without 
having to write it first into a disk file. To 
get started type the comand — 


PI SAMPTE] 


a = 
and push the return key. You can now write your 
first PC/PILOT statement. Type in the line 


T:Bello world! 

after you push return you should see 

Bello world! 

This is an examole of a TYPE statement. The T is 
called the op code. Notice that after the op 


code you put a colon and after the colon you pit 
the text which was to be displaved by the type 
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| Nar Sat ee ‘ occ — Sets = 24 = see: 4 

| : putting in another stype statement “°~ 

| statement. Try put nother «i : a 
| for practice. By experimenting, see what happens “SN” ©. 

| if you type the T op code in lower case. Als0 =.= * 

| see what happens if you leave off fhe colon = 

| after the op code. : Sec 


: a a s. 
You should have noticed that jtadoces not matter 
whether the op code is upper or Lower -Gaseé- You 
should also have seen that leaving .off “the -egion _ 
-character after the op code is. Gons ite an 
error by PC/PILOT. In that case:PC/RInOr-shqus 
you the statement it cc ngicerns in errors 
followed by a message thet sells ewhat it 
considers to be wrong. Usuat,/ ah will peceasy 
for you to tell what is weEorgs tat if you-need 
more explanation check. “the “EgeOR MESSAGES 
section of the Reference -Macual. tera meee 
in a ‘ram you can choose ‘tp Stop . prog 
by ee obing ctri-c (that is:holdige down the ¢trl 
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key while pushing the C key}. -@r: you can push — 


any other key to just. 


continue -on with ;the 
execution of the program. - 
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If you do not haye a color adapter on your 
computer, you should skip this section since you 
ean not do graphics on a monochrome adapter. 


TRYING OOT 


If you are not still running the SAMPLE] program 
get it started by typing 


Next you can try out the GRAPHICS statement. To 
do so you must first select a screen mode which 
allows graphics. Also for convenience you can 
establish a text viewport at the botton of the 
screen to keep the things you type isolated- from 
the graphics you draw. To do this type 


TS -M4-V0 ,39,20,24 


and push return. The TS op code is used for 
several purposes; what you did here was to set 


screen mode 4, and make the last 5 lines oEF-the- 


screen the text Viewport. You should have a 
blank screen now and the cursor should be toward 
the bottom of the screen. 


To draw graphics you tell an invis ible turtle 
which direction to turn and how many steps to 
take. AS the turtle moves it can draw a line of 
some chosen color. When a program starts, the 
turtle. is in the middle of the screen and is 
pointed towards the top of the screen. Try the 
following statement which tells the turtle to go 
forward 100 steps. 


G:F100 

You should see a vertical Line appear. Now try 
to tell the turtle to turn to its right and go 
forward another 100 steps. 


G:Ro0: F100 





You should see a horizontal line appear making a 
right angle with the vertical line. In both the 
above statements the G is the op code for the 
GRAPHICS statement. The F100 is a forward 
command for 100 steps. The R90 says turn right 
90 degrees. You can put any number of commands 
after the colon as long as each is separated 
from the next one by a semi-colon. Try this 
statement: it completes the drawing of a box. 


G:R90;¥'100 ; R90 ;F100 


You can change the color of the lines drawn by 
the turtle like this: 


This command sets the line color to color number 
1. See the GRAPHICS section of the Reference 
Manual for information about the various colors 
you can get. Try drawing a box in the new color: 


_G:F200;R90; F200; R90; F200; R50 ; F200 


Notice that in the above statement the same 

ance is repeated several times. There is a 
short hand way of representing this on the 
GRAPHICS statement. Try the following statement, 
‘it is equivalent to the last one. 


2*4 (F150; R90) 


The notation *n({...}) lets you repeat any 
commands in the parentheses n times. This turns 
out to be a very powerful feature as you will 
see by trying out the following statements. Two 
new commands are used below. The E command on 
the GRAPHICS statement causes the screen to be 
erased. The L command tells the turtle to turn 
left. Try each of these statements. 


G:E:*3 (F350;:R120} 





. G:E;*8 (F200;145) 


G:E;*5 (F240;R72) 





G:E;*20 (F30;L18) 
G:*5 (F300;R144) | 
G2E:C2;*72 (P400;RL75) 


There are a few other important facts to know 
about the GRAPHICS statement. One 1s illustrated 
by the following example. Try it to see what 


happens. 


G:E;880;*200 (FS) __. 


You should see the line run off the right side 
of the screen and come back on the left side. In 
general any time you draw off one edge of the 
screen you come back on the opoosite edge. This 
wrap around nature of the screen makes it act as 
if it were infinite in all directions. 


Actually there are 320 individual dots or 
pixels, as they are called, across the screen. 
They are numbered from 0 on the left to 319 on 
the right. There are 200 pixels from top to 
bottom; they are numbered from 0 on the top to 
199 on the bottom. You can tell the turtle to 990 
to any particular pixel by giving the horizonal 
or x position and the vertical or y position. 
Try these statements for an example. : 


G:G20,15;F30 

G:G300,100;F5 

Normally one step for the turtle is ome quarter 
of a pixel. That means that it would have to go 


at least four steps to make a line two pixels 
lona.You can control the horizontal ané vertical 
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scale factors to set the size of one turtle 
step. Try the following three statements. They 
Show the effect of the scale factors. 


G:E;G130,100 

G:*3 (F40;R120) 
G:k4-v4-*3 (P40-R120) 
Notice that the same triangle is drawn but it is q 
four times as large the second time. The reasori 
1s that the X and Y scaling factors are each set. 


to 4. At this setting a turtle step is one pixel 
on the screen. 


“There are several uses of the scale factors. One 


is to compensate for a display screen which has 
pixels that are mot square. For example, if when 
you draw what should be a square it is a little 
wider than it is tall, you could adjust for it 
by setting the X scale to 3 and the Y scale to 
4. A second use of the scale factors is to 
purposely distort a figure. For example, the 
following statement draws what would normally be 
a circle, but by setting the scale factors see 
what happens instead. 


GrEsX3-¥1;*20 (F20-R18) 


You should see an elipse which is about 3 times 
as wide as it is high. 


At this point you should read the GRAPHICS 
statement section of the Reference Manual. After 
having tried these few examples it will make 
more sense to you than it may have before. You 
Will also notice that there are features 
described there that were not covered here. 


Before you go on to the next section you can 
clean up the screen by enterina 


ll 


~, 


———— 


Which takes the screen out of graphics mode and 


puts it back into text mode 0. 


LL ssi a 


-. 


If you are not already running the SAMPLE] 
program then start it by entering 


PI Srizl 


A variable is a word which names a storage 
location in computer memory. PC/PILOT has two 
kinds of variables. The first kimd is a mimeric 
variable, which as you might guess, can store 4 
number. The COMPUTE statement can be used to 
save the result of a computation in a-numer ic 
variable. Try for example: 


i -— 


C:X=3+4 _ 


To umerstand what this -statement does you might 
read it as "save the sum of 3 and 4 in the 
variable xX". You can display the value of a 
yariable thus: 


T: $x 


You should see 7 displayed. Notice-that the # 
itself is not displayed, meitner is the &. 
The # character tells tho TYPE statement that 4 
numeric variable follows and that the value of 
the variable, not the name of the variable, 
should be displayed. Numeric variables have many 
uses such as counting the number of rignt and 
wrong answers. We have used the variable name =, 
but you could chose any word that would help you 
remember what Purpose the variable is to Serve. 
Try these three statements which might be found 
in different parts of a program. 

C: WRONG = 0 

Cc: WRONG = WRONG + 1 

T-You bad PaRONG incorrect answer. 

In this case the variable is named WRoMG. As a 
Side note, the examples snow yariable names in 
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upper case only; in practice you Can use upper 
or lower case interchangeably in variable names. 
That is, the variable name SCORE refers to the 
same Value as the variable name score. 


A second type of variable is the character 
string, or just string. It can be used to save a 
list of characters, like a person's name. There 
are two important facts about a string variable. 
First, the name of a string variable always has 
a $ on the end of it. Second, you have to use 
the DIMENSION statement to set aside memory 
space for the string before you can use it. Try 
the following statement. It defines a string 
variable called NAMES, and sets aside enough 


memory to store up to 10 characters. és 


D: WAMES (10) 


-_ —_— 


The compute statement can be used to set a 
string variable in much the same tanner as a 
Tameric variable. Try these two statements. 

C: KAMES-= “Mickey Mouse" : . 
T:I like SHAMS. 


If you did it exactly as shown then you would 
see a line like 


I like Mickey mou. 


Since you set up NAMES to hold up to 10 
characters, only the first 10 characters were 
saved. Why are there two $ characters, one 
before and one after the variable? The first $ 
indicates to the TYPE statement that a sting 
variable name follows and that the value of the 
string variable is to be displayed. The second $ 
is actually part of the variable NAMES. 

It would be very helpful at this point to read 
the sections of the Ref2:ence Manual that 
describe the COMPUTE and DIMENSION statements 
and the sections on VARIABLES ami EXPRESSIONS. 
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| A FIRST PROGRAM 


If you are still running SAMPLE] then stop it by 


' pushing ctrl-C. 


To write a program you must create a text file 
with a name that ends in .PIL: for this example 
you should use the name FPIRST.PIL . The EZ 
editor that comes with PC/PILOT makes this 
process very simple. If however, you already 
have a text editor you would rather use, go 
ahead, it does not matter how the program gets 
into the text file. EZ is described more 
completely in the Reference Manual, But just to 
get you started this time, type 


EzZ40 FIRST.PIL 


‘You will see a line that says-new file, then the 


screen will go blank. You just start typing the 
lines you wish. After each line you just push 
return. If you make an error you can use the 
backspace. or-arrow keys to move to the spot in 


error, then-type the correction over the error. 


When you are done just push the £10 key. Try 
entering the following simple PILOT program. 


D2NAMES (10) 
f:Hello, what is your name? 


A: SheeES 
T:Hi SHAMES, nice to met you! 


Once you have typed it in, save it by pushing 


the £10 key. Next try running the program by 
typing 


PI FIRST 


The first statement sets up a string variable 
called NAMES and reserves 10 characters of 


memory for it. The second statement types out 
the message Hello etc, which is the first thing 
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vid see on the screen. The next. line 
eee ACCEPT ANSWER statement signified By 
the A op code. It tells pc/PILOT to ne on 
student to enter a response. Nothing Ase oe 
happens until the student types someth ale 
pushes the return key. Assuming the ‘stu e : 
types a name, like Mary. The next TYPE omen: 
displays a message "ui Mary, nice to meet you 


n ¢ ! ypect it to 
Tf the program does not run as you exE 
then use the editor to correct the program ana 
try it again. To edit the program with Ez enter 


EZ40 FIRST.PIL 


exactly the same as you did when creating the -- 


program to begin with. You will see your Lara 
on the screen. Just move the cursor to the mies 
you need to fix using the arrow keys. Then type 
the corrections over the errors. 

you should try running the program 4 few omer 
with different responses. See what nappens i 
you enter a Very long name, Or NO name -at all. - 


Also, if you are using EZ then you should en 
read the section in the Reference Manual Ww = 
describes it. Try out each command or oe 
key to make sure you understand what it 1s US 
for. 


The MATCH statement is one of PILOT’s most 


| unique and powerful features. It is used to 
| judge the last student answer against a pattern. 


The end result of the MATCH statement is simply 
a YES, the student answer does fit the pattern, 


| or NO, the student answer does not fit the 


' pattern. The YES or NO result can be used to 


conditionally execute or skip over any statement 


-_ 


. would be executed only if the previous MATCH 
statement resulted in a YES. Otherwise-it would 
' be skipped. Conversely; the statement 


4:That is wrong. ~- - 


would be executed only if the previous MATCH. 
statement resulted in a NO. Otherwise it would 
be skipped,” - - . ee 


—_ = 


You have considerable latitude in coding the 
match pattern. First of all, the student answer 
does not have to match the pattern exactly, it 


‘need only contain the pattern somewhere within. 
“That is, a statement M:ADTO would give a YES 


natch for a response like AUTOMOBILE or SEMI- 
AUTOMATIC. In each case, the pattern AUTO is 
contained somewhere in the student response. 


You do need to consider the distinction between 
upper and lower case. If you wish to treat 
answers in either case as equivalent, one way to - 
do so is to use the PROBLEM oo code to set the U 
option. This forces all student input to upper 
case as it is stored in the internal answer 
buffer. Then you would code all match patterns 
in upper case. This scheme would work equally 
well with the L option and lower case. The S 


J 


option can also affect how you code the match 
patterns since it causes the removal of all 
spaces from the student answer. 


There are several ways you can enhance the match 
pattern to allow for variations in the student 
answer. It is very important to do so in order 
to avoid unnecessary frustration on the part of 
a student who gives an essentially correct reply 
which happens to vary slightly from the expected 
reply. There are two wild card characters you 
can use, namely the ™** and the "s". The ™*" 
matches any single character in the same 
position of the answer. For example 


M<OL*MPIC would match OLYMPIC or OLIMPIC. 


The "s" matches any sequence of zero or more 
characters. For example ; 

M-REDSBLUE would match RED, WHITE AND BLUE or 
REDBLUE. One way to think of the "4" is that it 
means "and". So the statement would mean that 
the word "RED" and the word "BLUE" must be 
present in the given order. fo 

Often there are several alternative replies that 
need to be allowed. The "I" character can be 


used to separate several possibilites. ™!" is 
often thought of as meaning "or". For example 


M:boat! ship 


would match either the word "boat" or the word 
"ship". 


The "*", "gs" and "!" can be used in any 
combination within 4 match statement to give 
very flexible answer checking. For example: 


M:catsdog!be*r! Lion 
would give a YES match for "cats and dogs", 


“qrizzly bears”, "sold beer" or “lions and 
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tigers”. 

'Sometimes the match is a little too flexible. 
Consider the statement M:no which obviously 
expects a negative answer. If the student were 
‘to reply "I don't know" ,it would match since 
the answer contains "no". In cases where the 
match needs to be restricted you can use the “#” 
character. It matches only with a space or the 
start or the end of the student answer. Some 
examples will clearify. — 3 


= - 


M: tnt 


would match “no”, but not "I don't know” because 


the first % says the word must -not be preceded 


by a non blank character and the second % says 
the word must not be followed by a non-blank 
character. Another example: §  . e—- 


would require a word that ends in "ed" since the- 
* would match any character and the % requires 
that the ed be followed by a space ( or be at 
the end of the answer.) 


The MATCH statement can be told to forgive minor 
spelling errors by appending the S modifier to 
the M op code. This will allow a YES match even 


when the student resoonse differs in some small 


way from the pattern. This means you can ignore 
minor mistakes made by the student without 
deciding ahead of time what mistakes might be 
made, For example 


MS =PILOT 
would match with "PILOT, "PILII", "PILATE", or 
"PYLOT". 
You can use this program to experiment with 


various MATCH statements. Use it to try the 
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features of the MATCH. 


As 


M: (put whatever you want here) 


Ty:That matches. 


T:That does not match. 


o:8A 


T:Input a reply or ctrl-C to quit. 


25 


| DISPLAY MODES AND FEATURES 


With PC/PILOT you can use the screen in several 


| different MODES. The display mode tells how many 


character rows and columns there are on the 


screen, what colors appear and whether there may 


, be graphics displayed along with text. In some 
“modes you can have several display pages. A 


display page is a screen full of information, 
one of which is currently visible. 


The actual colors and display quality you see 


depend somewhat on the display adapter you have 
(color or monochrome), and the monitor you have. 
In decreasing order of display quality, the 
types of display you can have are: RGB color 
monitor, composite video monitor and TV set” 
connected via an RF modulator. In general, the 
things documented here apply only to systems 
with a color adapter card. If you have a 
monochrome adapter then you get no color or 
graphics. ' 


The TYPE SCREEN or TS statement is used to set - 
the desired screen mode. For example 


TS :M4 


| Sets screen display mode 4. 


When a program begins the mode it set to mode 0. 


The modes are numbered from 0 through 6. Modes 
4,5 and 6 allow the use of user-definec 


characters. In other modes the standard 


character set is always used. The GRAPHICS 
statement may be used only in modes 4 and 5. 


The NEW CHARACTER statement can be used to 
change the apperance of any printable character. 
All characters are formed on the screen as a 
block of dots which is 8 high and 8 wide. You 
define a new character shape by constructing the 
dot pattern you wish to see with the *." and "/™ 
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characters. The character is displayed with its 
new pattern any time it is displayed in screen 
mode 4, 5 or 6. Read the section on NEW 
CHARACTER in the Reference Manual. | 


Display modes 0 through 3 provide more than one 
display page. Normally display page 0 is 
Visible on the screen. To make another display 
page visible use the TS statement. For example 


TT :P2 


would make the currently displayed page 


disappear and make display page 2 appear. Any 


text displayed would now be placed in page 2. 
Later if the statement 


TS :P0 : = — = 

were executed then page 2 would disappear and 
page 0 would appear and would look exactly as it 
had before. One use of display pages would be to 
set up a frequently used display frame in ‘some 
specific page by making it the currently visible 
page then doing TYPE statements to set it up. 


“Once it is set up, change to sOme other display 


page. Then, whenever the saved display is wanted 
it can be instantly flashed onto the screen by 
changing the page number. This scheme would work 
well for help menus which may be called for at 
various points in the program. 


Tne TYPE SCREEN statement also allows you to put 
text anywhere on the screen you wish to do so. 
The screen always has 25 lines of text 
available, the top line is considered line 0, 
the bottom line is considered line 24. Depending 
on the display mode there may be either 40 or 80 
characters across each line. The leftmost column 
is considered 0, the rightmost is either 39 or 
79. In placing text on the screen you soecify a 
character position as two numbers. The first 
numSer is the column number, the second is the 


2d 


line ocr row number. 


Column and line numbers are used in two ways. 
First, you can define what is called a VIEWPORT 
on the screen. A viewport is just a rectangular 
section of the screen in which text can be 
displayed. When a program starts out, the 
viewport is considered to be the entire display 
screen, You can set the viewport by a statement 
such as = -* 


7S5:W0,39,15,24 ~~ 


which sets the viewpor t_to be from column 0 on 
the left, through column 39 on the right and 
from line 15 on the top through line 24 on the 


bottom. In a mode with 40 columns this would- 


make the viewport equal to the bottom I0 lines 


of the screen. When a viewport is set in this 
| way, the cursor is placed at the home, or upper 


left corner of the viewport. Any text output 
would display from that point on, and text will 
be dislayed only within those bounds. If the 


" wiewport becomes full it scrolts up ome line to 


accomodate the next line of text. In doing so, 
all display data outside the text window is left 
unaltered. You can change the viewport as often 
as you wish; this facilitates the use of various 
parts of the screen to display certain data. 
Each time a new viewport 15 set up, PC/PILOT 
remembers what the previous ome was. You can get 
back to the previous viewport by a statement 


TS:V;: 


which sets the viewport and the Cursor position 
in the viewport to whatever 1t previously was. 
To see how a viewport works try this program 


T:This text is outside the viewport. 
T:So it is umaffected by what 1s 
T:Bapopening in the viewport. 
T5:V10,30,11,16 , 
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Chica os eee oe * 


ei 


75 th 


T:This text is inside the viewport. 
T:Type something 

T:and I will type 

T:it back. 


As 


ES: 
T:#%3 
J:8A 


-~ 


You can position the cursor anywhere within the 
current viewsort by a statement like 


TS :G5,6 


which tells the cursor to go to column 5 and row 
6 of -the viewport. Remember, column and row 
numbering starts at zero. If you specify a row 
or column too big for the viewport then the 
cursor is set as close as possible to the 
Specified position while still remaining in the 
Viewport. ~ . 


The TYPE section in the Reference Manual also 
describes certain control characters which, if 
included in a TYPE line can cause the cursor to 
move. 


Normally, text is displayed as if it were single 
spaced. You can display text double or triple 
spaced by setting the line spacing option thus: 

TS:L2 . 
which means that from now on one blank line is 
left between all text lines that are typed 
(double space). 
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MODES AND COLGES 


The TYPE SCREEN statement can be used to Spec ify 
the foreground and background text colors. To 
experiment with this start the SAMPLE] program 
by entering : 


Now enter the following lines 


-— 


'S:M1;B2:F1 | See _ 


 ‘'¥-This is blue om green. 


TS:V¥5,35,10,20;B0;F5 
T:This is in a black viewport. 


This should show the kinds of things you can do. 
In general the foreground color is the color of 
the character itself, and the background color 
is the color of the square on which the 
character is displayed. However, there are some 
differences in the actual effect of the 
foreground and background colors depending on 
the display mode you are using. First of all, in 


the text-only modes (0-3) there are 8 colors to | 


choose from for background or foreground. They 
are numbered from 0 to 7. On color monitors 
which implement the brightness signal there can 
be 8 additional foreground colors (8-15) which 
are brighter versions of the first 8. For 
background colors 8-15 you get the same 
background colors as for 0-7 but any characters 
written on a background color from 8 through 1 
will blink, or flash, on and off. Setting the 
foreground and background colors in these modes 
Goes not affect the characters already displayed. 
on the screen, only the characters subsequently 
displayed. Since the TZ: statement (TYPE with 
CLEAR modifier on) does the equivalent of 
writing blanks to the entire viewport, the 
effect is toclear the viewport to the current 
background color. If the screen is still as set 
by the above Sequence of statements try the 
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ed 


following three lines to illustrate this point; 


T5:B4;F0 
T:Now using new colors. 
TX:Now have cleared the viewoort. 


The screen border, or perimeter of the display 
screen always has the current background color. 
Whenever the background color is changed the 
border color changes immediately. , 

Modes 4 and 5 are called the GRAPHICS Mones 
because they allow the-use of graphics along 
with text displays. However, the use of color in 


these modes is different from text-only modes... 


First of all, there are only four-colors 
avallable at a time. Three of them (colors 1,2 
and -3) are predetermined by the mode. Check the 


| Reference Manual TYPE SCREEN section to see what 


the predefined colors for modes 4 and 5 are. 
Color 0 is defined to be the current background 
color as set by a TYPE SCREEN statement. The 
background color can be set to one of 8 colors 
(numbered 0-7). In the graphics modes setting 
the background color immediately affects the 
background of all data currently displayed on 
the screen. This is different from what happens 
in text-only modes. Also important to note is 
that in these modes the GRAPHICS statement can 
be used; and that the line colors (O—3) that can 
be drawn by the GRAPHICS statement are the same 
four colors available for text foreground and 
background. 


In all cases you should note that if you choose 
a background and foreground color that are the 
same, then anv text displayed is invisible. In 
fact, unless you have a very good color disolay 
device then choosing foreground and background 
colors that are even too similar can have the 
Same result. 


Use the SAMPLE] program to try out various 
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combinations of modes and colors to see what 
| works well with your own particular system. If 
you get an unreadable combination you can still 


enter commands, even though you don't see them. 
If you get in this state just push return then 


TS:40;B0;F/ 


which sets things back to the way they are when 
the program starts. In fact, whenever you leave 
a PC/PILOT program you should set the mode back 
to mode 0 or mode 2 which are the normal 40 and 
80 column modes used by DS. 


You may have noticed that the cursor looks 


--@ifferent in text and in graphics modes.-iIn the -- 


text-only modes the cursor is always displayed 
and it blinks. In the graphics modes the cursor 
does not blink and it is only displayed when the 
program is waiting for the user to type 
something. : 

BOW TO CHOSE THE BEST DISPLAY MODE. 

When designing a lesson it is good to think 
about the specific type of display that will be 
used. The results can vary significantly with 
the type of monitor (RG3, composite video color, 
Ty set with RF modulator or b/w monitor). Modes 
0 and 2 give colors similar to mode 1 and 3 on 
an RGB monitor only. On a composite video or RF 
modulator these modes are monochrome with good 
character quality. Modes 1 and 3 give the 
colors documented in the manual. The color 
quality depends on the monitor. Modes 4 and 5 
give color on all monitors but the character and 
color quality are excellent only on an RGB 
monitor. On all others, the colors seem to have 
fringes of other colors. If you have a color 
adavter card with a b/w monitor, modes 1 and 3 
give yery poor character quality. If you have a 
monochrome adapter card you should use mode 2 
only. 





ABIMATION 


If you are not already running the SAMPLE] 
program start it by entering . 


PI SPLEL 


PC/PILOT allows for a limited form of animation, 
or movement of figures on the screen. It can be 
accomplished by the combination of several 
commands on the TYPE SCREEN statement. The 
features, which are described separately in the 
Reference Manual are as follows. The ANIMATE 
comm allows the display of text by a TYPE 
SCREEN statement. It allows the text to be 
displayed across one line or as a block of a few 
_ characters on several lines. For example 


—_ — 


"6S :M0 ; ABI Mom 
gives a display that looks like this _ 


Bom - - - = 


The animate command does not end up moving the 
cursor from its original position. To move the 
cursor the WALK command is used. It can be usec 
to move, or "walk" the cursor one space in any 
direction. For example, try this statement. 





TS:Al;WOR;A2 WOR; AG 


which should display a "1" then walk down and tc 
the right one space, then display a "2", walk 
down and to the right, then display a *3". 


A third component in making motion is the 
ability to specify a repetition m of severa-’ 
commands. This is done on the TYPE SCREEN mucr 
the same way as on the GRAPHICS statement. Tr; 
this statement making sure you enter it exactly 
as shown (no extra spaces). 
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TS: 730 (AX; 


} You should have gotten a line of thirty x's. 


Here's why: the *30(...) means to do what is 
in the the parentheses 30 times. In the 
parentheses you have an animate command which 
displays an "X", followed by a walk command 
| which moves the cursor one space to the right. 
The net effect... thirty X's in a row. 


- “Notice in this next example how inserting a 


-Space can cause each previous X to be erased 
before putting cut the next XK First push RETURN 
then try this Statement exactly as shown 


TS:*30{A X;WR) ci eer 


The only difference is the space before the x 
But what happens on the screen. Why? The animate 
command now displays a space, then an X. Then it 
moves right one from where it started, which 
puts the cursor under the X. The next time 
through ‘the loop the space overwrites the 


” previous X (thereby erasing it) and another x is 


displayed after that. It probabl l 
pia : ! 7 yY went a bit 
fast so try it again and watch closely. 


If you wish to_slow the motion down you can do 
So by using the DELAY command. For example 


TS:*30(A X:WR:D5) 


Note the addition of D6 which means delay f 

> the add oa 
period of six 60ths of a second. By alacine the 
DELAY in the loop, there is a tenth of | 
delay between each X. ieee 


You may have noticed that the cursor remains 
visible as the animation procedes. Remember that 
in screen modes 4 and 5 the cursor is visible 
only when the user is typing. Try the Following 
two statements which change to screen mode 5 
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= 


Be 


then do the same animation. 


S35 
TS:#30(A X;¥R:D6) 


This looks better 
visible during the animation. 


Statement. In fact a figure may be made up of 2 


since the cursor is not 


block of several re-defined characters to make e2 


Shape bigger than one character cell.” Thi 


example shows a block that looks like 
Wek 


eo mewed, but the characters used could b- 
rs ee re-defined characters You wish. Alserc 
Lock Could be any number of Characters. 


TS:*20(A WXx/ YZ ;¥4R: D5) 

Or to mve it right to left- --  - cae 
TS: *20 (WL AK /TZ :D5) 

In these as in other I i 

a 3 h animation seque 
Placement of SsDaces in the sitadbee ance 


important to ; . 5 ; 
ria > avoid leaving a trai} behind on the 


~~. eo ao 
ee 


Tee ee tl a ; . fe - 
en ee es ce Sot io = eal - . a a Sen . % =a 
ee es oe a a ee ee See aenh iaa  ae a  a g = a ye “ 

i eee ee ne ee 


PC/PILOT does computations in a manner similar 
to other programming languages such as BASIC. 
For example, to do a computation and assign the 
result to a variable the statement would Look 
like this. : 


C:X=({¥y+i10) /3 
C: is the opcode for the COMPUTE statement. 
Everything to the right of the "=" is called an 
expression. In this case, 10 is added to the 
value stored in variable Y, the result is 


_divided by 3 and that result is stored in 


Variable X. . 


A second context in which an exoression is 


useful is as a conditional, such as 
J(X% < 10) :LOOPA . 


In this case-the expression X < 10 1s evaluated 
as either 1 tf true or 0 if false. I£ the 


' expression is true then a JUMP is taken to the 


label LOOPA. If the expression is false the JUMP 
statement is skipped and the control passes to 
the statement after the JUMP. 


Use E240 or another editor to enter the 
following program as file LOOP.PIL. 


R:Sample loco progran 
Cc: I=0 

BACK T: #1 

C: I=I+tl 

J{I <= 10) -BACK 
T:Done 


Now run the program by entering 


PI LOOP . 
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You should see the numbers from zero to ten 
displayed. This is an example of what 1s 
usually called a loop. it consists of the 
following general steps. 


(1) Set a counter variable to an initial value 
(Cc: l=9 ) 

(2) Define a label at the start of the loop 
( *BACK 


(3) Do the statements that are to be in the loop 
(T: 22 ) an - 
(4) Set the counter variable to its next value 
(C: T=I+1) 
(5) Test the counter against a limit and jum 
back to the loop start label if not yet at 
the limit ta ‘ - = 
“" { J(T <= 10):BACK ) 


— —_ 


In computing expressions there are 4a number of 
operators which can be used. They include the 
expected things like add{+), subtract(-)- 
multiply(*) and divide(/). These operators do 
the computation to an accuracy of “about 6 
places. In computer jargon te comautations are 
Gone with single precision floating point math. 
There are also all the various comparison and 
logical operations such as less than(<}), greater 
than(>), equal to{=), and(&), or(t) etc. These 
coerations always return a 1 for true or a 0 for 
false. You can refer the the Reference Manual 
section on OPERATORS for more information. 


Also provided are some FUNCTIONS. An example of 
a function is 


C: A= IntT(x/2) 


In this case INT is a function. It gives the 
value of whatever is in parentheses truncated to 
an integer. For example, if X has a value of 7, 
then X/2 gives 3.5, and INT(3.5) is 3. So the 
variable A is set to 3. There are many other 
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statement is executed, 


| functions described in the sectiom on FINCTIC3s 
: that are not discussed here. 

"However, there is one more function worth 
: Frentioning here. It is the FEY function. The KEY 


— . 


: function tells whether or not a key has been 
_ pressed on the keyboard. To understand its 
| utility you have to consider how the ACCEPT 


statement works. Normally, whenever keyboard 
input is expected from the student, an ACCEPT 
ta | The ACCEPT statement 
waits for the student to enter a reply and push 
return. Even the ACCEPT SINGLE-statement waits 
until at least one key is pushed. Now, consider 
a program in which the action should not stoo to 
~wait for an input. Perhaps the program is a 
Simulation game in which the student must 
respond in response to something changing m@ the 
display. In_ this case if the program executes 
and ACCEPT statement then everything waits until 
the student replies. The solution is to use the 
KEY funtion to pericdically test for a depressed 
keyboard key. If there is none depressed then 
the program can go on with whatever else it is 
doing; if a key is depressed then the KEY 
function tells what the key is and the program 
can take the appropriate action for that Key. 
The following program shows the essential 
elements of this sort of logic. Use an editor to 
put it on disk as file KEYS.PIL 


R:sample use of KEY fimcticn 
C:I=500 

*XYa 

C: K = Key(0) 

TH(K) :#K 


When you run this program the screen will begin 
to fill ith qd aa ~ . i - a : 2 

> fill up with dots. While it 1s printincs the 
cots just pustr a key here and there on the 
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keyboard. Whenever you do you see a number 


printed. Try at a couple of times then read the} 


notes below. (To run it enter PI KEYS ) 
Motes on the above program 


There are several interesting points illustrated 
in this program. First you should recognize the 
loop construct with the variable I used as 4 
counter. In this case I counts Gown from 500 to 
0. Tie last two-statements of the program cause 
T to be decremented by 1, then the JUMP is taken 
based on the expression "I". Since an expression 
is considered false if it is zero, or true if it 
not zero, the JUMP is taken each time through 
the loop until I becomes zero. When I becomes 


zero the JUMP is-not taken and the program ends. 


The statement TH:. displays one period each time 
it is executed. The H modifier on the TYPE 
statement says not to put the cursor on the next 
line after the TYPE. That's why the dots fill 
across each line. 7 


= = 


The statement C: K = KEY(0) sets the variable RK 
It is set to zero if no key has been depressed. 
If a key has Deen depressed then K is set toa 
number which represents the key value. For 
printable characters the number is the position 
in the ASCII table of the character. For 
example, a space is 32, al is 48, andA is 65. 


You can refer to an ASCII table, such as the one . 


in your BASIC manual for other characters. 


The statement TH(K):#5 is another TYPE statement 
with the HANG modifier. It is conditioned by the 
expression [F) which means if K is mot zero then 
execute this statement. Since K is zero if no 
key 15 depressed then this statement is skipf 

unless a key is depressed. If a key is depressed 
then the numeric value of the key is displayed. 


This program is also useful to see what values 
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|) . you get for the various control and function: 


keys on the keyboard. Tr 
» y the pr in: 
this time push some of the contek and ection 


, keys. 


en cone of 


a ae 


ee ee 


ee ee 


ARAALS 


PC/PILOT allows for arrays or lists of mumeri 


values. Before a variable can be used as aj 
array, Space must be set aside for it by t 
DIMENSION statement. For example 


D: ABC (20) 


establishes an array named ABC with 21 entries. 
The first entry is refered to as ABC(0) and the 
last one is refered to as ABC(20). To refer to 
any particular element of.an array, you enclose 


a subscript in parentheses after the array name.” 


The subscript can be any expression which 
evaluates to a number from 0 to the defined 
upper bound of the array. Key in the following 
program and try it to see an example of array 
use. Call the program ARRAY.PIL . ~ 


R:sample array program —- 


D:A (10) 

R:loop to fill array with squares 
C:I=0 

*TLOOP1 C: A(I) =I * I 2 » 
C2I=I+l ~ - ~ + 
J (I<=10} :LOOP1 

R:loop to display the array 

C:I=0 

‘Tome? T: #2 = BA(T) 

C:zI=I+l 

J ({I<=10) :Looe?2 

T:bye 


What would happen if the the DIMENSION statement 
were changed to D:A(9) ? Make this change to the 
program an run it agaim The program should stoo 
two times with error messages. You can look up 
the error messages in the Reference Manual to 
see what they mean. 
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STRINGS 


. Besides doing computations with numbers you car 
| Manipulate strings of text. To do so you can use 
| String variables. A string variable is 
distinguished from a numeric variable in that a 
String variable always has a $ appended to the 
end of the variable name. Por example HAMES . 
Before a string variable can be used to store 2 
string value space must be set aside for it by 
the DIMENSION statement. The statement 


D: 25 (100) 
establishes a string variable called ZS 
(pronounced "zee dollar") and sets it maximur 
length to 100 characters. At any given time 7$ 
can store from zero to one hundred characters. 
The mumber of characters stored in z$ is calle2 
-its length . After the DIMENSION statement 25 
has no characters stored in it so its length is 
zero. A zero length string is sometimes refere- 
~ 6 as a null string. There are several ways tec 
get a value stored in_a string variable, One way 
is via a COMPUTE statement as = - 


C: 2 = "This is a string value." 


A second way is as an argument on an ACCE PT 
statement. This puts the student reply in the 
. String. ” 


A: $25 


Whenever a new value is stored in a string 
Variable then string variable's length is set 
equal to the number of characters assigned to 
the string variable. The LEN function returns 
the current length of a string. For example 


C: L = LEN(ZS) 


Sets variable L to the number of characters in 
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You have already used the String variable to 
Save the student name ang include it in feedback 
messages to the student. There are Mary other 
uses of strings. x YOu wish to remove all 
commas and periods from a student answer. The 
following sequence would accomplish this. 


D:X¥$ (80) 
A: 


C: %%3 = or (", *) 
C: XYS = Sap(*, *) 
C: X¥S = RSP (XYS) 


— — 
— = 


The first line Sets up string XY$. The second: 


line accepts a-reply and stores it in the answer 
buffer ($B), The third Statement changes all 
commas in the answer buffer to spaces and stores 


String XYS and Places the result in X¥S. The 
entire effect is to Set XY¥$ to the student 
answer with all commas and spaces removed. If 
the result is then to be judged by MATCH 
Statements then it could be put back in the 
answer buffer by a statement 


C: 2 = AYS 
The system Variable %B is called the answer 
buffer. It is where the ACCEpr Statement saves 


the student answer. It can be used in an 
expression as if it were a String variable with 
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maximum length 80 characters. 


There are several] String functions and one 
string operator. The String operator is 
concatenation. Its purpose is to join two 
Strings together into one string. For example 


C: AS = BS 11 CS _ 


sets string AS to a value qual to what is 
Stored in BS followed by what is stored in cs. 


A substring or-piece of a String can be used by 
Supplying subscripts after the string name. . 
There are two allowable forms of. string 
subscripts. The first is demonstrated. here. 


C: AS = BS(4) 


This statement sets String variable AS to the 
one Character at position 4 of string BS, It 
does not change BS. When computing character 


positions, the first character in a string is 
considered to be position 1. The seco form is 


C: AS = BS (5,3) 


Which sets AS to the 3 Characters found starting 
at position 5 of BS. 


When subscripting str ings, the subser ipts can 
not specify a substring that is beyond the 
Current length of the String variable. 

It is also possible to assign to a substring as: 


C: AS(4) = "x" 
C: BS (5,3) = "ABC" 


In these cases the assigned value is truncated 


Or padded with spaces on the right if it is not 
the correct length for the sudstring. 


a4 


STUDENT RECORD KEEPIEG 


PC/PILOT can keep a file of. student records 


called E.REC. You have complete control over 


- what data is kept in the-file. One simple 


example is shown here. The example shows how to 


~ save the student's name anda score when the 


student completes the lesson..Let's assume. that 
the student's name is placed<in the string 


- wariable NAMES at the start. of.the program by 


statements that look like this. 


D:haAsES (20) 
T:what is your name please? 
A: Shares 


Also assume that as the =program runs, two 
numeric variables are set; the first, called 
TRY, is set to zero at the“program start and 
incremented by one each time. an answer is 
accepted. The- second, called. RIGHT is also set 
to zero at the program start, but is incremented 
by one each time the student. inputs: a correct 
answer. Thus. at. the program. Start would: be -- 


C: TrRr = 0 
C: RicaT = 0 


and after each ACCEPT statement: which sii saa an 


answer attempt the line. 

C: TRY = TRY + 1 

and after each MATCH for a correct answer 
CY: RIGHT = RicaT + | 


Then, when the student’ ‘reaches the end of the 
lesson, the variable TRY- has the. number. of 


‘attempts made and the variable RIGAT has the 
number of correct answers given. . 


To get-a record placed om-the file K.RBC the- ~ 


| rer acaaaiiaet is used. In. this case 





Kz WaMeS 1) %-" 1) TRE f) S-" Ut RIGHT 


saath ntact Siesta cme 0 
mumbers to be to the end of the student 
_ records file. The record might look like this 


Mary Mhite-3-6 


The sample KEEP statement shown creates the line 
by using the concatenation operator (I! ) to 
combine the name, a dash, the number of tries, a 

dash and the number correct. This expression 
takes advantage of the fact that PC/PILOT 
automatically converts the numbers TRY and RIGHT 
“to strings to suit the context- of the 
concatenation. operator which expects string 


arguments. : : 


..Once out of the PC/PILOT program the file KREC 


can be examined by entering the DOS command 
TEE, _K.REC.. ain 

or. by editing K.REC with a text editor. If you 
wish to compute’ statistics “from the data_in the 
file it | it could -be done with a BASIC program, OF 
another nother PC/PILOT program | which reads the . file, 





The K.REC file continues to accumulate records 
_ until. it is explicitly “erased by the DOS comand 


- BRASS K.REC 


There are many other possible ways to use KEEP’. 
For example,-when you are first testing a lesson 
on students you may wish to save every response 
entered by a student so-you-can later make 
improvements: based on the experience. A simple 
way to do this is to place a KEEP statement 
after every ACCEPT statement. The keep statement 
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ght look-like this.-~ t 
. LE | | ‘é 
: ne ZH : oe | . USING SUBROUTINES 
fis line a "1-" followed whatever is in Sige ee Aye OE 
mis Line puts. © gp) .to.the Knee. file: The | - ~~ ** a a : Sometimes a section of a program performs Som 
is-simply.to identify which ACCEPT | a ae logical function that is useful in more than om 
statement inthe lesson is being answered. The : a i pa . —— context. In this case it is helpful to make tha’ 
cyt BOCERT would be ‘followed by : al a -* ae - program secticn what is called a subroutine. : 
. at a fae eubroutine always begins with 4 label and end 
g:.°2-" AL- 8B: - - . : with an END statement. Usually 4 subroutine 1 
=a ee SS - : ~ OF : = placed within a program in a place where th 
an so on. Later. when you TYPE K.REC you S< what | —: a - ; normal flow of control will not just "fall int 
AOCEPT statements ..were replied to and what the | | the-subroutine, so the only way toget toiti 
replies “OO ; | , by a reference to its label. The USE statemen 
ee | -- — i : : works in a manner similar to the BASIC languac 
| : a =— = - __ GOSUB statement. _ 
Once a subroutine is included in a program the 
“s i it can be used by other parts of the progre 
. whenever its specific action is- desired. The & 
statement calls a subroutine as follows: 
— = — . _ : - 2. _ *Uzlabel : 
: USE is much like JUMP in that control passes 
, ° the statement after the designated label. T 


difference is that with USE, PC/PILOT rememoe 
: : where the USE statement is by saving 1 
cation on something called the USE STACK. ™ 
when an END statement is executed by t 
subroutine, PC/PILOT can pick up the retr 
_ = vocation from the USE STACK and come back to ' 

statement after the USE. 


Subroutines can be nested; that is, ¢ 
subroutine can USE another subroutine. E 
subroutine returns to its caller by execut: 
and END statement. Key in this program 


ats =< : USEIT.PIL and run it. 
F | ; T:first 
i " an oh, ) sa U:sublL 
Ee = T:seconmd 
= <, — 7, U:-sub2 
AT en eee et T-third (continued on next Pp: 
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PR: E 

J: overit 

*SYSX C: *8(1) =" * 
x: BB 

E: @A 

foverit 


This sequence takes advantage of the ESCAPE 


option which works like this. The PR: E enables 


the ESCAPE command to he used. Later in the 
program, any time an ACCEPT statement is 
executed PC/PILOT checks. the first-character of 
the answer for a "@" character. If the "e" 
character is found then PC/PILOT calls the 
subroutine SYSX as if a statement U:SYSX were 


- executed, i. a = 


The purpose of this sequence is to supply a SYSx 
subroutine which contains 3 statements. (The J: 
overit statement insures that the SYSX 
subroutine is not executed until it is called 
for.) The first statement Cs tB(1) = ** 
changes the "@"-to a space. The ‘second statement 


~ executes the answer buffer as a statement. The 


third statement ends the sysx subroutine and 
goes back to re-execute the last ACCEPT 
Statement (the one from which we came}. 


Here's how you use it when You are testing your 
lesson program. When the program starts the SYSx 
subroutine is skipped over because of the JUMP. 
Each time your lesson does an ACCEPT statement 
you can do one of two things. You can just 
answer the lesson in the normal way in which 
case nothing special happens. or, you can put in 
a PC/PILOT statement, preceded by the "a" 
character. For example, if you entered 


@T:#xX #Y #2 
you would see the values of variables X,Y and Z 


at that point in the program. Then you could 
answer the question in the normal way since you 


ei 
a 


would be right back at the same ACCEPT statement 
after the variables are displayed. If you wished 
to change the value of variable X in the program 
you could enter 


@c: x=5 | 
This allows you to set up to test certain 
situations in the program. If you wish to jump 


to another location in the program you could do 
so by entering 


@2: label 


The reason for E: rather than J: is that since 


! tatement -you. put in is executed in a 
eee, you exile want to end the subroutine 
before jumping off to some other point. The END 
statetment with a label does just that. It 
should be pointed out that the GOTO command 
could be used for the equivalent action. To use 
it the first statement in the sequence shown 
should be changed to 


PR: BG 


This enables both the ESCAPE command and the 
GOTO command. Then, to jump off to another place 
in the program you would just enter 


GoTo label 
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A second handy use of EXBCUTE INDIRECT is t 
save a GRAPHICS or SOUND statement which is to 
be used repeatedly in a string variable. Then to 


' repeat the GRAPHIC or SOUND statement only the 


string variable needs to be used. Enter and run 
the following sample program as file EXIN.PIL to 
try out this use. 


ts: © 

d: cir$ (50) 
e: cir$ =" 
ec: i= 4 
*mery xi:cir$ 

g:f£35;r9 

|e: i= i-l 

j(i): many ; =i sata 7 
We - 

ts:m0 

e: 


:#18 (£30;r20)* _ 


The variable cirS is used to contain a GRAPHICS 


statement that draws a circle. Try Changing the 
third line of the program to 


ec: cir$ = "g:*8(£60;r45)" 
then rum the program again. 


The next section. shows another good use of 
EXECUTE INDIRECT. As is typical of this 
statement, a whole program scheme is built 
around the capability even though there is mly 
one EXECUTE INDIRECT statement in the program. 
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———————— 


One very typical technique in a CAI program is 
to give the student a random set of problems 
chosen from a large set of possibilities. This 
makes the lesson slightly different each time it 
is run. The following program outlines one 


. method for doing this. The actual question 


frames are not here, you could £ill in with 
whatever questions you wish. What is shown here 
is how to randomly select a group of-the 


| questions. 


First, a few assumptions: suppose that the 
student 1s to be given 10 questions out of a. 
possible set of 30 to chose from. Each question 
begins with a label of the form 


— =< = — 


where "nn" is a number from 1 to 30. Suppose 
also that the student must not be given the same 
question twice in one sitting. And when the 
student has completed the 10 questions his name 
and the number of correct answers on the first 
try are to be stored in the student records 
file. The program would start off something like 
this. 


R: 0 is used to keep track of 
R: which questions given so far. 
D: 0 (30) 
R: next two lines set @G to 0's 
Cc: & = 70000000000" 
Cc: 6 =05 11 6 11 05 
R: N is used to coumt questions done 
R: C counts maaber right om first try 
R: RASES is student's name 
D: NAMES (20) 
:NH=0 
Cc: C=0 
: (continued next page)” 
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A: SOMES 
fT: You will be doing 10 probless. 
T: Ready? 
A: 
R: here to select another probles 
*NEXT 
R: P is problem mmber selected — 
R: next line gets a mumber from 1-30 
Alt 7 

P = Ro(30) +1 


Cc: 
Soe R: next line jumps back to try again 
FR 


if question previously used. 
J(OS(P)="1"): AGAIN 
c: GP) = 71" 
R: next line calls the question frame 
XI: "U:Q0ES" I! P . 
R: count one more cone 
C: R=HRel |. 
R: jump back to do more if not dome — 
JTH<10): NEAT -+ 
R: 10 questions done, save results 


K: wees 1! C 
R: next line returns to DS 
E: 


As you can see, the program is heavily laced 
with REMARK statements. Remarks like these don't 
affect how the program runs but they will make 
it much easier for you to- remember later how 


your program was intended to work. AS an. 


absolute minimum you should always include 
remarks that state what all the variables are 
used for and should prefix each logically 
distict sectiom of a program with a few general 
remarks about what the section does. 


The above program section would be followed by 


thirty question frames. For things to work 
properly each question frame would have to 
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“£ollow a few rules. First, the question frame 
- must begin with a label like QUES], QUES2, QUES3 


and so on up to QUES30. If you wish to use 
numbers other then 10 questions out of 30 
possible it should be very easy for you to make 
the appropriate changes to the above program. 
Notice that the question frames are invoxed Dy a 
USE SUBROUTINE statement. This implies that each 
question must end with and END statement. The 
END statement returns control to the statement 
immediately following the EXECUTE INDIRECT. 
Also, for the variable C to_be set properly, 
each question would have to add one to C if, and 
only if, the student replies correctly on the 
first answer attempt. The student's name is 
available in the variable NAMES if a question 


frame needs to include it in a message. The - 


variable N should not be changed within a 
question frame since it is used to count how 
many questions have been completed. 


An aporopriatly coded question frame might look 
like this : 


= — 
- 


*QUES3 

TX: In four-four- time, how many beats 
- Goes a HALF NOTE get? 

A: 

M: 2! two 

TY: Very good. 

C¥Yl: C=c+1 

EY: 

M:1!one 

TyY:No, that would be a quarter note. 
M:3!4!thre! four 

TY:Ho, not that mony. 

Tl:Try again. 

72-Hint: it's twice what a 

quarter note gets. 

T3:The answer is 2 beats. 

Ej: 

J: 8A 





ee 


This question frame Presents the question, | 
nip 


accepts an answer and checks to see if it is 
nr mae If it is correct the message "Very 
oe ple ees In addition, if it is 
See: i! is the first attempt then 1 is 
: to variable C (CYl: cexc¥4 1). Then, a 
return 1s made to the main loop after ‘a correct 
che we the EY: Statement which says END if 
Ee - was YES. After that there are some 
aa ack messages for anticpated incorrect 

ers and_some succesive hints for successive. 


-- incorrect replies. On the third incorrect reply 


the student is given the 
1S ended by the E3: statement. — 


Create a program file - 7 
‘ : : named QUEST.PIL and enter 
in Both the Program start section and the pains 
question given. Rather than make up 30 questims 
ati nice Cry out the Program you can try it out 
nite © one question Sy changing the EXECUTE 
RECT statement to be the following instead. 


U:QUES3 - ies 
This would have the aac oom: 

| fect of choosing thi £ 
sample question every time, Make this’ stiri 
the program file and rim it. _ 


This program can serve as the i othe 
, | mM cqutline fo : 
Programs you might create in the future. ° ; 











MULTIPLE PROGRAM MODULES 


CAI lessons often tend to be very long files. 
There are several good reasons to construct a 
large lesson as a set of smaller modules. One 
reason is that very long files are not 
convenient to handle with most text editors. 
Another is that constructing a large program out 
of smaller logical subdivisions results ina 
more structured program. This facilitates later 
additions and changes to the program. With _ 
PC/PILOT each module of a program is created as _ 

a text file with a suffix of .PIL in exactly the 
Same way aS an individual program would be. 


“One PILOT program can pass control to another by 


the LINK statement. It has two possible forms as 
shown here. 


L: PARTS 


The first example above links to a file 
PARTS.PIL and begins execution at the first line 
of that file. The- second example links to file 
MATN.PIL and starts execution at the label NEXT 
within that program. 

LINK works in a manner similar to CHAIN in 
BASIC. 

All variables, arrays and strings are remembered 
across a LINK and can be continued to be used by 
the linked module. 





a modifier is a letter appended 
Tt causes some change in the way 


to an op-ccde. 


the statement 
modifiers are shown 
sponding 


if no 


string cn 16-nyte boundary 


To: type screen 

BS: pt single 

BS: matcn spelling 

Bu: allow type ates ; 

I: aro jump to next match 

PJ: machine level CUT instruction 
AX: accest with Gefault keyboard values 
TA: cyce clear 

SAS arapnics image 

wis file coen/cicse 

DA: allocate 

HA: redefine input key value 

PA: absolute mMEMOry 


pee moaifier ts s or X) 15 ecde 
co t+ is ignored. 


- J 
co 


aon any other 


; 


St ial 


mo ere eT epeed tient wl uaeael arr” 


/ cxorrica 


n 

tter, Gigit cr expressio 

. te es eat = e. Th e condi 1ticnal causes 
i 

the  eacement to be peed only if che 


t is false 
dition is true. TE i : 
gees 1s skipped. ah comaltl tonal 


i ie 


coded on 4 TYPE stac Cements 
same cn any stateme! 


P 
Gien the sta rement 


is shown below 4s > 
nowever, they work tne 


a Ie tyoe if last matcn was YES 
— if last match was NO 
=n type if error flag is a _—— 
the expression is evaluat if ~ 
iil me (non zero} tnen the statement is 
Lo Sal 


ise it is skippes. 


executed, otherw Se efits 
TC type if previcus expres s . 
<4 wate 2 mber “pei 1 Fo 9, Type 
mn Mma‘ be a numec- Rais 
a : = ble alee ” Le de ry accept counter. 
if 15 equal TO cle a 
it Th _ —_ ns | yr cc. Pe | cr 
aE unmter 15 4 VYailo west 
Tire accepe counter 7 Se 
twos the last eccel. 
Lis ‘ tt my I a: Le ee oe ae. — 
tells how man’ 
ane 7 4- a row 
has Deen ayeacited in 4 


5 ail must be te 
he nc 
tH be exscucce. 


Ty: Correct 


bing c 


Tloount+2 < LIMIT): Nor look at to1s. 
JC: REVIEW 


a — aha a 
oi. That's your third wrorg cry. 


oe eee 


Seo also: MATCH, ACCES TL 


of fade ere 





‘ One or more str 


a ee se & . = 


: 1 


A: $variable fvariable t 


8 


ACCEPT is used to input a student response. The 
response may be as long as 80 characters. The 
actual maximum response may be set by the A 
option of the PROBLEM statement. The student 
types her response, using backspace as 
necessary, followed by a return key. The 
response is automatically editted per the 
ootions set on the last PROBLEM statement. The 
editted response is then placed in the system 
variable #8, also called the answer buffer. If 
the X modifier is not included then the values 
input for each key on the keyboard may be 
affected by vrevious NX: statements. If the & 
modifier is included on the ACCEPT then the 
input values of all keys are the default 
Standard regardless of any previous N&: 
Statements. 


Input characters in the range of ascli 32 to 255 
are accepted, see appendix A for a Listing of 
the standard character set. 


Normally, the student can not use type-ahead. 
That is the answer can be keyed only when the 
ACCEPT statement is actually reached. However, 
the J medifier (AJ:} allows type-ahead to be 
used for this ACCEPT. 


— S (single) mcedifier accepts one keystroke 
nly. No editting of the value is done; it 15 
oa in the answer buffer as a one character 


String. AS: can be used to detect function or 
cursor keys 


ing or numeric variables may be 


INCLUGeO Vie wis sewers =~ a ‘ 

variable, the value of the answer buffer is 
assigned to the string. For each numeric 
variable, the first number found in the answer 
buffer is assigned to the variable. If no 


number is found, the E conditioner is set to 

true. _ 
f 

If enabled by the last PR: statement then the 


student can cause a program jump by entering 
"coTO destinaticn". 


If enabled by the last PR: statement then the 
student can cause the equivalent effect of 
"y-SYSK" by beginning the response with the “am 
character. 


A: #24 
TE: Ineed anumber. Try again. 
JE: 6A 


AS: 
T: The key value is #(ASC(38)) 


See also: PROSLEH, Wx:, GOTO AND ESCAPE 


| bo 


7° COMPUTE - assignment statement 
” 
c: target = expressicn 


The expression is evaluated and assigned to the 
target. The expression may yield a number or a 
str ing. The target may be 4 simple variable, 2 
cubscripted array Vat iable, a string vat jable, 4 
subscripted str ing variable, oF the system 
variables %B OF an. Since $B 15s considered 2 
be a string yariable it can be supscripted. fr 
the type of the expression does not match the 
type of the target it is automatically conver ted 
from string to numer ic or numeric to string to 
match the target tyPe- 





When assigning to 4n unsubseripted string 
wariable the value is trunc 2 


a 


dimensioned string length if it 1s | . 
Then the string variable 1S assiqned tne value 
and it takes on rhe length of tne value. When 


= 
~ 


truncated OL blank-pedded on che : 
the substring- The length of the str:: 


assigning toa eubscripted string th 
r 


< 

ju 

pe! 

‘= 

(D 

Jo pte 


c: 1$(50,135) = "UNITED: STATES" 


C: TABLE (I) = RND (L090) 


eS S ae 


G. | . i 
/ DIMENSICN - allocate arrays and strings | 


= 


| ~ “ EXD - terminate subroutine oT program 
D: variable (size) ,-.- ‘ 0 FE fan Baer py AaesSR HBSS RENTS Re - 
Da: variable (size) E: 
. BE: destination 
DIMENSION creates an array of numbers Or a4 on ee | 
character string. If the variable ends with the Scat Hee Fes If there is no unended USE in effect the EN 
"s" character it is a string, otherwise itis an | | ~ gauses the termination of the program and 
array. The amount of array and string space return to DOS. If there is an unended USE 1 
available is depencent cn the amount of memory | effect then END pops UP the USE stack Dy on 
installed up to a usable limit of 128k. A entry. Then if there is no destination on th 
- character string is allocated space to hold a END a return is made to the statement after tr 
string up to the specified size. It is corresponding USE. tf there is a destination ° 
initialized to length zero. A variable cannot : the END then the return is made to tne 
_be_used as a string until it has been | destination rather than to the statement aft: 
“dimensioned. A numeric array is allecated space the USE. 7 
for sizetl real numbers. The first position in | 2 erate ert 
a numeric array is subscript zero. Array Hs = ene alesse “USE -st+ 
elements are not initialized to any particular. | 
value. EXAMPLES : 
If a string variable is to be used to contain a BE: 
machine language subroutine (see V: statement) | 
then use the DA: Op code to insure that the | FE: NEXT 
string is allocated ona 16-byte boundary for | 
compatibility with segment register Limitations. |) *QUITE:QUIT (always returns to DOS) 
D: X(20),¥ (39) 
D: NAMES (50) 


See also: SUBSCRIPTING 
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FILE - access external files 


FA: 
Fi: 
FO: 


position expression, Var iable$ 
posi tion-expression,value—expression 


The FILE statement allows access to disk files. 
Tt can also be used to access the printer OF 
auxiliary port. Only one external file may be 
open at a time. The first form shown above 
closes any previcusly opened file then opens the 
named file for access. If the filename does nct 
exist it is created automatically. . The special 
file names PRN: and AUK: are used to open the 
printer or RS232 port for output. The FA: 
without a file name just closes any OPS" file. 


positions the file to the 


) Tf an attempt r 
beyond the end of file the string variable 15 
pedced with cum(255) characters. 
FO: positions the file to the 
specified by cosition-expression then writes © 
string value of the value 2on t 
number of bytes written is equal to the lenge 
of value-expression. 


| 
iD 
G 
4 
(pb 
(i) 
tf) 
} 
if 
a 


The position-expression is ignored for files 
PRN: and AUX:. No automatic appending of 
control characters is done. If you wish to 
write returns, line feeds, etc., Dut them in the 
value-expression. See also BUX function. 


EXAMPLES : 
FX: DATAFILE.XY¥2 cerset 


FI: 100, DS 
EQ: 


a0 ee rr 


ure 8 
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CX ” GRAPHICS — display graphic images 


G: command-List 
GX: filename 
Gox: filename 


The GRAPHICS statement works only in screen 
modes.4 and 5. The first form allows the 
execution of a list of turtle graphics commancs 
to draw lines and shapes. The seco 1 form reads 
a previously saved graphics image from a disk 
file and displays it on the screen. The third 
form saves the current screen display in-the 
specified disk file. The disk file is 16K bytes 
and corresponds to an exact bit map of the color 
adapter display memory. {see GIE manual) 


A list of turtle grapnics commands consists of 
one or more of the following commands, separatec 
by ";" characters. Turtle graphics consist of 
telling the (invisible) turtle which dGirectior 
to head and now far to walk. AS the turtls 
walks it can leave a colored line on che screen 
The turtle's heading ranges from QO deqress, 0! 
straight wo, to 359 degress witn the headin 
angle incressing 4$ it rotates to its rig. 

rhe t t o +: ‘ 


Fak. bo a 

the ovoosite edge. in te commanc de 
below n represents a numeric ° =f 
integer constant. 


Hn set turtle heading to n cegress 

Rn rotate turtle heading right n deares 
Ln rotate turtle heading left n jeqrees 
Fn walk forward n steps 

Cx,Y set turtle location to pixel x,¥ 

Dx ,¥ draw a line to pixel location *-¥ 
Cn set line color for For DP ton {0-3 
E erase screen to background color 
*n{..+) repeat the enclosed commancs n time: 
Xn set horizonal scale factor 

¥: set yertical scale factor 


——— a 


“G:6106,200:D150,85 


“be texclusive ored with 


G: X6°¥3:*36 (F1LO;R10) 


See also: 


In modes 4 and 5 the screen is 320 pixels 
across by 200 down with valid line colors 06-3. 
Color 0 selects the current background color as 
set by TYPE SCREEN. Colors l, 2 and 3 are 
determined by the current mode as selected by 
the TYPE SCREEN statement. 


Color 1 Color 2 Color 3 
MODE 4 (GREEN RED YELLOW 
MODE 5. CYAN MAGENTA WHITE 


Adding 8 to the color number causes the color to 
the existing color. 
Possible background colors (COLOR 0) are 
documented under TYPE SCREEN. 


The X and ¥Y scale factors can be adjusted for a 
particular display to achieve uniformity in 
horizonal and vertical step sizes. The default 

= 


value is X%1:Y¥1 , which makes a turtle step siz 
equal to one quarter of a pixel. To make a steo 


equal to a pixel set the values to 44;%T4. 


EXAMPLES: 

G: *19(F60;R20) draws a circle 
G: *4(F30;L90) raws a Dox 

G: C2:*5(F160:R144) draws a red star 


draws an elicse 


draws a line from 
{100,200) to (150,385) 


ee Pee ol 
Ter 
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Gestination 


the current PC/PILOT program file 
-s control to filename.PIL. If the 
stination is given then a JUMP 1s 
ly made to that destination in the 


tt “" some — goto a destination 
J: label 
ug: 8A 
J: @P 
uo: GM 


JUMP transfers control to the <a stome 
Gestination. The destination may be a gaara 
label. In this case do not put the ™* cee 
the label on the J: statement. The on 
destination causes a jump back to the last 
ACCEPT executed. The @P destination causes = 
jump to the next PROBLEM. The € destinatio 

causes a jump to the next MATCH. 


EXAMPLES : 

J: 8A 

3: NEXT 

See also: STATEMENT LABEDS 


' 


UMP 


ce cman erie dh tna a DS a ae ED zl 





K: expressimm 


The KEEP statement writes the expression value 
to the end of the file K-REC. If K.REC does not 
exist it is created automatically. A new-Line 
sequence is appended to the string expression as 
it is written to the file so the resultant file 
is a standard ascii text File which can be 
listed or processed by an editor. The K.REC 
file continues to grow until it is explicitly 
erased by a DOS command. | 


x: "PARTS VINAMESHRIGHT. wv 
*O3 As 


Ke: "Q3tfisb saves student response 
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Chain to another program file 


= 
x 





/ LINK - chain to ancther program File 


L: filename 
L: filename, destination 


LINK closes the current PC/PILOT program file 
and transfers control to filename.PIL. If the 
optional destination is given then a JUMP is 
automatically made to that destination in the 


new program. 


EXAMPLES: 
L:CHAPTERZ 

L: CHEM ,Q3 

See also: JUMP 


‘4 


/MAICH — compare student response 


' M:patterm 
MS :pattern 
MJ :pattern 


MATCH compares the student answer buffer (%5) 
with the pattern. The result is a YES or NO 
.Mmatch which can be tested by the Y¥ oF N 


> eonditionals. If the S (spelling) modifier is 


given then the match is YES even if the student 
made minor spelling errors. If the J (jump) 


modifier is given then upon a NO match an. 


automatic JUMP is made to the next MATCH 
statement. 


If the pattern is found anywhere wi 
answer buffer then a YES match resu S 
following special characters may be embedded in 
the pattern. 


= Matches any one character 
& matches any string of zero or 
more characters 
! separate alternative patterns 
& matches only a space or the start or 


end of the answer buifer 


The result of the match can be tested by the ¥ 
or N conditionals. 


{continued next pace) 


13 
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EXAMPLES: 


statement response result 
M:HAT HAT YES 
M:SHATS HAT YES 
fATTES NO 
M:CAT&DOG CATDOG YES 


DOGS AND CATS NO 


MS:GREEN GREAN TES 
MS:CATIDOG CAT ane 
SSS DOXS YES 
M:H*T BOT a 
tees. HAT ibe 


See also: ACCEPT, JUMP, CONDITIONALS 


tw 
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f HEW CHARACTER — redefine Character pattem = . ae 





=c . = ee - 
weeffone ! << e modes 4, 5 and 6. In other modes the standard 
wef /f/- “a el | oo character set is always used. 


St Tif- > - 1 


af<—-= = = The NX: statement Mey be used to change the Cade 
-oe/ foe Lc oe ‘ generated by eny key on the keyboard. rhe ore 
wwnffes i a codes generated are shown in append 1x A. The 
eoeffers 7 > | : _ number x sown above stanas fOr ene norma. 
7 default value of a key, the letter ¥ stands £0 
WX: Xs¥ 7 *e¥ ~~ rhe new value to be generated by the key. 1 
must be in the range 0 to 255. Any number © 
The N: statement changes the 8 by 8 dot pattern ‘ “= keys may be redefined in one NX: statement. [Ae 
for any of the 128 changeable characters. The | : S a key has been redefined it affects all oe 
changeable characters are the characters from | statements except those with tne a Rae = 
128 to 255 in screen modes 4,5 and 6. Prior to Bicei= oe modifier or ai ACCEPT statement pauses any << 
execution of any m: statement the characters | 2 FL -lpe-definitions to be ignored for Ulet BOCES - 


from 128 to 255 have unpredictable displav 


patterns in modes 4,5 and 6. Once at least one : 7 EXERMPLES : : 
N: statement has been executed, the characters | 

from 128 to 255 that have not been exolicitly | p: define 7 to joow like ae 

changed will have tho same display pattern as mi ff/ET ELS fone ee f faswees , oes allt 

the corresponding characcer in the range 0 to Picmmeih pa a ee POPPSPEL SS 

127. The N: statement hes no efiect on the 

characters displaved in screen modes 0-3. In S.. dyes teenies 
those modes, the characters Gisclaved are alweys ge caise key EL to-gesste* code 225 (Sets! 
as shown in appendix A. The letter c shown in Na: 187,225 

the format of N: above stands for any character 


R: cause upper Case a to give a-accent 
wx: 65,160 ; 

R: restore upoer case A To normel 

wy: 65,65 


From 128 to 255. The EZ editor provides a wav to 
enter characters in that range into a program. 
It is followed by 64 periods and slash 
characters. They depict the pattern of zero (.) 
and one {/) bits that will be used to displa 
the character. The 64 bits may be di | 
lines of 8 bits eac: v | 
the character pattern. Or, tne 64 bits mav be 
given all on one line, or any desired format 
that adds up to 64. Intervening spaces er 
ignored. _ 


cee also: TYP. SCRE, ACCEPT 
ach to give a visual picture of 
ea 5 ei 
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/ peperest — set cpoticns 


PROBLEM has two uses. The first is to provice a 
destination point for a J:@P statement. In this 
case PROBLEM can be put at the beginning of each 
frame or question. The second use is to specify 
one or more lesson options. The list consists 
of zero or more of the option letters below. If 
no letters are given: then all cpticns remain as 
previously sét. Otherwise each option is set 1 
the corresponding letter is present or reset 1 
the letter is omitted. = 


Ph rh 


U if set, all student responses are 
translated to upoer cease 

L. if set, all student responses are 
translated to lower case 

S if set, ail sseces are removed From student 
resoonses 

G if set, the GOTO commend is emablead 

E if set, the SSChEE command is enabled 

W clears the label teble and forgets about 
All Jabels vaesecd so far. Thus 12 <3 
impossible to jump backward. This allows 
the same labels to be used again 
subsequently. 

An sets maximum ACCEPT response length ton, 
nmay be a nutber frem 1 to 80. If n<ior 
m>80 then it 1s set to 80 

z if ccded alone, causes U, L, 5S, G and & 


SS es 


to i mor ol 
1 
4 


= 
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Px:offset, value 
BJ :acddress , value 


The value must be a number or expression from 0 
to 255. PE: stores the byte value in memory at 
the offset given. The offset is from a segment 
whose base is specified by the system variable 
SA. Great care must be taken in using this 
statement since a mistake could cause system 
failure. PJ: performs a machine level OUT 
instruction to the device address given of the 


byte yale. 


If you have both types of video adapters 
(monochrome and color) you can switch from the 
monochrome to the color for PILOT cutput via... 


C: *A=0 
PX: 1040,pek (1040)-16 
(then set desired mode via TS: statement) 


and you can change back to the monochrome via... 


C: *A=0 
PX: 1040,pek (1040)+16 


(then set desired mode via TS: statement) 
[ ; 
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—_————e ; vats «amma ini 
progr ies : - generate 
R: remarks |: ; 

sz list 


REMARK is ignored during program executicn. It 


can be used to document a PC/PILOT progran. SOUND is used to generate simple tones, noises 


: or beeps for audio feedback. The list contains 

, one or more pitch or pitch/duraticn values. The 

, entries in the list are separated by the ™;" 

, “ . character. The two possible forms of a list 
| 


ees A 


entry are: 


pitch 
pitch, duraticn 


SS eS | where pitch 1s a number or variable from 0 to 


2047 and duration is a number OF yariable from 1 
+p 632. A duration of 34 gives about a one 
° second tone. The lower the pitch value the 
higher the tone. The higher the Guration value, 
the longer the tone is played. If the duration 
is omitted after a pitcn (first form above) then 
j - pitch is used. 


e 


Lu 
the duration of the prevl 


res Of notes by 


"4 
aoe 


It is possible to repeat a se 


the notation: 
*n (11st) 

where n is a number or a variacle. A pitcn value 
of 0 give silence. Normally, doubling a pitch 
lowers it by one cctave. Halving a pitch raises 
it by one octave. 
EXAMPLES? 

S: 200,25;300,8;100,16 

S: *4(208,5;224) 


R: 
S+ 500,10;446;400; 374; 333; 301; 
S: O> 


SESS SLL tare sete err! Wed 


/ TYPE — display text on screen 


T: text 
TH: text 
TX: text 
: text 


TYPE is used to display text and/or variables oF 
expression values on the screen. The x (clear) 
modifier clears the text viewport to the current 
-packground color and homes the cursor prior to 
the text display. The text is displayed only 
within the current viewport with end-of-line 
wrap .and scrolling as necessery- Tf the 
(hana) modifier js’omitted, the Cursor is spaced 
down as specified by the current line spacins 


value after the text 15 displayed. 


The text may contain 2 numeric or string 
variable preceded by a or aS. The value of 
the variable 1s substituted in the tex: cutmout. 
lf the variable isa string or array 1t may be 
subscripted. If a space occurs after the 
ar 


* ta = _ " _ 34 aire 
yeriable name,the space 15 not displayec. 

mnt =e — ‘ ae oe ee oe | | “a. 
“he text may contain dil expression precsss DY 
5. b | 


or $ and enclosed in parentheses. The valu 
of the expression 1s substituted in the te: 
cutout. 


The text output may contain any printable 
character from CHR(32}) to CHR(255). The 
following control characters may also be 
Gisplayed by placing them ina string variable 
cr embedded expression. 


cun(e)= AC rel Gc 


CHR (9}=FORES2ACE 


CHR (10) =DOWN CHR (11)=UP 
CHR (12) =CLEAR CHR (13) NEWLINE 


ce (14) =BO 


7 a ie Ria t T ia =n Er. ana ti. 7 >= on os om tm 
MOLe Tita. ae eta Words cause tne Vilw Dori to 
= _ J . 7 7 Lal 
=a } ser Cone murcsar 152 CGF ei Ls we, tee de 
gecrolt WP is bes et Gor 1S Geb & e CO 28 dine 


' rat ee Pa eee Se ee ee 


—— EEE SS 


OO 6p ie momeemmms: |] 
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UP causes the viewport to scroll down if the 
cursor is on the top line. 


Any TYPE statement may be continued for aS Mean 
lines as necessary by placing a colon in the 
first positim of the next line. 

EXAMPLES: 


tT: Good job SNAME- | 
- Your average is ¥(TOTAL/CCUNT)- 


“<—?Tx: This is ona clear screen. 


TH: This 15. all 


= g; en one. Line. 


See also: TYPE SCREEN 


— 


ate 


- x / Twee SCREEN -— set screen options, animate ta 


TS: list 


TYPE SCREEN is used to control screen modes and 
colors, define viewperts on the screen, set line 
spacing and make animated graphics. The list 
consists of one or more of the following 
commands. Each command is separated from the 
next by a “;" character. In the command 
descriptions below lower case letters cenote a 
numeric variable or an integer constant. 


Mn - set screen mode and erase screen. 
Possible modes are 0 through 6. 
Ln > set spacing between text lines, n<=l 


sets single spacing, n=2 sets double 
spacing, etc.. 


Fn —~ set foreground text color, possible 
values shown below. 

Bn —~ set background color, possible values 
shown below. 

En -~ set background color and clear the 


current viewport to the background 
color: cursor set to home position in 
Viewcoort. 

an - in modes 0-3 sets color of the border 
or outer frame of the screen, in mde 
4-5 has same effect as Bn, in mode 6 
sets the text color. 

V1,r,t,b - set screen vlewport to be from column 
lon the left through column r on the 
right and from row t on the top 
through row b on the bottom. see 
below for more information on 


viewoorts. 
V; -~ restore the previous viewport and 
cursor position. 


Atext - animate; the text is displayed from 
= the cursor position. If the text 

, contains a "/“ character, the "/" 1 

not displayed but the next character 
is displayed on the next -line down 


i 


fla 
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and directly under the original 
cursor location. Text is displayed 
up to a ";" or the end of the 
statement. After the text is 
displayed the cursor is left where it 
was when the animate began. This 
command is useful to draw figures 
made up of a block of several 
redefined characters. 

display text page n. In modes 0 and 
1 n may be 0-7, in modes 2 and 3 n 
may be 0-3 in modes 4-6 n may be 0 
only. In the text modes (0-3) there 
are multiple display pages one of 
which is the currently visible page 
on the screen. The normal default is 
FO. 

delay for n 60ths of a second... This 
is useful when using animate within a 
locp to move a ficure on the screen. 
walk right. left. up or down. The W 
can be followed by any number of r, 
1, u, or d characters. Eacn-one 
moves the cursor one space in the 
indicated Girecticn. Moving down cn 
the bottom line of a viewport causes 
the viewoort to scroll up; simliarly 
moving up on the top line causes the 
viewport to scroll down. 

position the curser in column x and 
row y of the current viewport. G0,0 
puts the cursor in the home positicn 
of the viewport. ; 
repeats the commands in parentheses n 
times. Any of the above commands may 
be in the parentheses. This .is 
useful to move a figure by reveating 
a sequence of animate, delay and walk 
ina lcop. - 


—_ 


ak 
i 
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‘clears, scrolls, etc-- 


-—EO the position prior 


= 


A viewport 1s a section of the screen which is 
used to displey all text cutput by tne program. 
when PC/PILOT starts the current viewport is 


defined to be the entire screen (v0 ,39,0,24)- _ 
The V1,r,t.D command defines a new section or 


the screen to be the current viewport. when 
this is done tne cursor is placed in the home 
cositicn of the viewport. All text displayed DY 
the program displayed only in the current | 
viewport, any data displayed outside tne 
viewport is unaffected as the viewport changes, 
~lear AV command without ts 
yiewport and cursor back 

VY commanc. 


four numbers puts the 
to the last 


This simplifies alternating between cwO 
yirewporcts cn the screen fOr suc uses 2s stucent 


responses and 


MCDE COLUMNS ROWS Y-DIXELS Y-PIKELS 
0 0-39 o-24 - e 
1 0-39 g-24 - = 
2 TS 0-24 = = : 
2 =79 q—24 = — 
al 8) ro in = ; - 
A g-29 Q-24 0-319 0-195 
c 9-39 o-24 g-319 0-199 
6 g-79 O-24 - ~ 
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COLCRS IN MCCES 0-3 e ee 
0 - BLACK 1 - BUE >. - GREEN 

3 - CYAN 4 -— RED 5 — MAGENTA — fos 
6 -— BROWN | ~ LIGHT GREY : ss 


FOREGROUND: canbe set to any of the above, on 
some monitors adding 8 to above number gives 
lighter version of same color. 


BACKGROUND: can be set to any of the above, 
adding 8 above numbers also causes any 
characters written to blink in modes 0-3. In 
modes 4 and 5 adding 8 gives lighter version of 
the same color. | 


COLGES IN MCLE 4 


color 
- YELLOW 


QO — current background 
1- 2— RED 3 


aT 
Stet 


COLCRS IN MCLE 5 


QO — current background color 


” 


Moce 6 is monochrome, white on black. 


BNIMATICN 


This example shows how to move a ficure across 


the screen left to right then right to left. 
ines . 


A - ow Ms 7 H ~ 
ficure is a block of four letters: 


ee 


Wa 
¥Z 
But it could be any-user defined characters 2s 
well. Notice that the animation string is 
carefuily laid out with Spaces to insure that 
is 3 5 wy | 


the previous one SO a trail 1 


Also note that the number after the D controls 


the of moticn. 
TS:M1;B0;F 1; 720% WX/ YZ;WR;D5) 


TS:*20(HLAWX /YZ D2) 


Mote: The various modes and colors apt Oe 
re the color adapter card. On eo a 
adapter the screen always works in 

mode. 


“gee also: ‘TYPE, GRAPHIC 


Ss not LELe Peis. - 
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“ USE -— call a subroutine 
U: Gestinaticn 


USE jumps to the destination and saves the 
location of the statement after the USE on the 
use-stack. A subsequent END statement in the 
subroutine causes a return to the statement 
after the USE. The destination can be any or 
those described for JUMP although the only one 


-. . which normally makes Sense is a statement label. 


os 


7 = 


= ByAMeT ES 


‘USE is similar to gosub in basic. 


U: GLOSS 


= J ~~ 
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VIDED — call external driver progras === 


y- wariableS 


VIDEO is intended to allow a PC/PILOT program to 
call a machine language subroutine to control a 
video disk or video tape. However, it could be 
used for many other purposes since it is 
actually a general purpose interface to any 
machine language program. 


The only argument of a VIDEO statement is the 
name of a string variable. The string variable 
must have been dimensioned long enough to 
contain the machine language subroutine, and the 
subroutine must have been placed into the 
string. The DX: op code must be used to 
dimension the string variable. This insures that 
the string begins on a 1l6é-byte boundary. 


The VIDEO statement causes a machine language 
FAR CALL to be executed to the first byte o£ the 
string. Upon entry to the subroutine the code 
seament and data segment registers are equal and 
point to a segment which contains the 
subroutine. Segment registers must not be 
modified upon return from the subroutine. Other 


1 
= 
— 
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registers may be used without saving the 
contents. The subroutine must return vila a FAR 
RETURN op-—code. Data can be passed to/from the 
subroutine by the PC/PILOT program in mutually 
decided portions of the string variable itself. 
The PILOT program can use subscripting - tc 
deposit or fetch data in the locations within 
the string designated by the subroutine. 


A qcod way to get the subroutin into the strinc 

variable is to read it from a disk file as snow" 

in the first example below. The machine 

language code must be in memory image format anc 

must be position independent since it may be 

Natural care should b- 
rm 


a | 

a ays 
i | aia : 1 4 . ~~ » is Me — = 
taken in using this statement since improper us= 


ses Ee ] 
oat 








Gan cause system failure. The DOS utility called 


“r. 
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= an 
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EXE2BIN may be of use in preparing the 
subroutine file. | 


EXAMPLE: 

Dx: suBS (1000) 
FX: VIDSUB.COD 
FI: 0,SUBS 

V: SUBS 


Gee also: samle program SAMPLE4 .PIL 


eels og ae 
a 
a 


cs 


Vv WAIT - program celay 
W: expression 


WAIT causes a program delay for expression 
tenths of a second. The delay is prematurely 
ended if the student pushes a key. Thus the 
example below waits for ten seconds or until a 
key is pushed, whichever occurs first. 


iba 
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EXECUTE ISDIRECT - execute a string 


XI: expressicn 


EXECUTE INDIRECT evaluates the expressim@ to its 
“string value. Then the string value is executed 
as if it were a PC/PILOT statement. The string 
may contain any valid statement up to length 80. 
If the string is tco long ocnly the first 80 
characters are used. The "I" of "XI" may be 
omitted; it is allowed for COMMON PILOT 


comatibility. 
EXAMPLES : 


hlem 


 ~R: “random selecticn of a problem 


MX: "J:PROB"!!RND(1O) 

R: store a graphic in a string to REUSE it © 
C: Boxs="G:*4(F50;R90-F100;R90)" 

XI: BOKS 


* 


EXPRESSIONS = 


PC/PILOT accepts 
An expression is 4 combination of variables, 
numeric constants, string constants, functions 
and operators. Expressions are formed in the 
normal manner allowed by other programming 
languages. Operator precedence is similar to 
that of 
subexpressions. Fach element of an expressi@m 
is a number or a string value. Numbers are 
stored in floating point form. Strings are 
stored in variable length form with a 
terminating null character. Each operator or 
function expects to act oa particular type of 
argument. And in turn produces a particular 
type of result. For example, + expects two 
numeric arguments and it produces a numeric 
result. A unique and convenient feature of 
PC/PILOT is auto-type conversion. This means 
that any time an argument is of the wrong type 
(string or number) it is automatically conver ted 
the correct type for the context. A number 
s converted to a string in a manner like that 
f the STR function, which puts the value in 
rintable format with decimal places only if 
ecessary. A string 1s converted to a number in 
a manner like that of the FLO function, which 
scans the string for the first number value OF 
S zero if mo number is founc. 


EXAMPLES: 
cs: X = 4*(A-B / (E)) 


woRDSS = CAP (LISTS (I.J)) 


ope 
tad 


expressions in many contexts. © 


basic. Parentheses may be used to group . 


ut 
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; ~- 
A variable name can be up to length six. |The 
first character must be a letter. Other 


characters may be letters or digits. The last 
character may be a > to signify a string 
yeriable. Upper and lower case letters are 
considered to be equal when naming 4 yariable 
(i.e. — AYS and xyz name the same variable). A 
string variable must be dimensioned in a D: 
statement before it can be used to store a 
string value. There are two system variables $A 
and 2B which can be used like other variables. 
¢3 is a number equal to the number of times the 
last ACCEPT has been executed without any 
intervening other ACCEPTS (l.e. - how many trys 
the student has made on this question). %B is a 
string variable which is set to the response 
given by the student on each AOCEPT. 


EXAMPLES : 

I3 

names 

See also: DIMENSICN, SUBSCRIPTING 


fi 
ihn 
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we Od EVE. 


array (position) 
stringS (positicn) 
stringS (pesiticn, length) 


SUBSCRIPTS are used to select an individual 
-yalue out of a numeric array, or a substring cut 


of a string variable. 
used the variable must have been dimensioned. 
Numeric arrays start at subscript zero and end 
at the dimensioned size. String subscripts 


start at one. 


Before subscripts can be 


when subscripting a string, if 


“the length is omitted, a length of one is 
An attempt to subscript beyond the 


assumed. 


.- current length of a string gives anerror. In 


general, a subscripted variable may be used 
anywhere a simple variable may be used. 
Position and length values may be expressions. 
A reference to an array variable without 


ubscripts references element zero. The system 


variable %B is a string and may be subscripted 


as such. 


EXAMPLES : 


A(I} = A(I+l) * 3 


i 


J(BS(I) = "A"): LABEL 


T: SHELPS (4,10) 


See also: 


DIMENSION, VARLABLES 


ice 
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/ WOMERIC CONSTANTS 


[-]digits 
[-]digits.digits 


A numeric constant consists of an optional 
leading minus sign, a string of decimal digits 
optimally including a decimal point. 


EXAMPLES: 
=) 


63.789 
-42.1 


f= 
of 


*text™ 


A string constant, or literal consi i 
| nsists o 
or more characters enclosed in quotes acl 


EXAMPLE : 


AS="BANANA" 
T(XS < "A™): NO SIR. 
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x+y .*-Y¥ x * y xf ¥ 
x % y (remainder of x/y) -Xx 


To compute A to the B power use EXP (B*LME(A)) 


x<yY x>yY x=Y x <> ¥ 
x<=y x >Fy 


Comparison is numeric if x is a number, or 
string if x is a string. For string comparisons 
the shorter string is padded on the right with 
spaces for comparison purposes. Relational 
operators give 1 for true or a zero for false. 


LOGICAL 

x&Y (true if both x and x are non-zero) 
xi¥ (true if either x or y rs non-zero} 
“x (true if x is zero) 


Logical operators always preduce a l for true or 
a zero for false. 


xS !1 yS (concatenaticn) 
Concatenation produces a string consisting of 


the string value of y$ appended to the right end 
of the string value of x$. 


A SaCTICAS. 

ABS (X) the positive value of x 

ASC (XS) the numeric value 0-255 of char X5 
ATW (X) arctangent in degrees of X 

AUx(0} © reads the coml: (rs232) port, returns 


48 


ms 


CAP (X>) 
COs (X) 
CHR (X) 
EXP (X) 
FLO(X$) 


TNS (X59) 


INP {X) 


TNT (4). 
KEY (4) 


LEN (X35) 
ENE (X) 
LOG (x) 
PEK (X) 


RAD (4) 


RSP (XS) 


STM (X) 
SOR (X) 
STR(%) 
Se (™xy") 


CHR(0) if mo byte ready to read, ora 
character from CHR(1) to CHR(255).The 
coml: port mst be set up vla a MCLE 
command before entering PILOT. 

the upper case value of string % 
cosine of X degress : 

returns the Xth ascii character 

e to the X power 

the numeric value of the first mumber 
found in string x5 

zero if character X$ is not in 85, 
otherwise the first position in 35 
where XS is found 

machine level IN instructicn, returns 
a byte from io port A 

value of X truncated to an integer 


zero if no key is pressed, otherwise 


the ascii code for the depressed key 

current length of string X> 

natural leg (base e) of & 

log base 10 of & 

returns a value from 0 to 255 equal 
to the byte in memory at offset A 
in the segnent whose base is in the 
system variable tA 

if X% is. zero returns a random 
fracticm from 0 to L If X>0 returns 
a random integer from 0 to xX-L 

the string value of X$ with all 
spaces removed 

sine of X degrees 

square root of & 

the string value of number & 

returns a string equal to the value 
of 3B except that each character x is 
changed to charecter y 


EXAMPLE: R:read N characters from rs-232 port 


D:X> (80) 

Cis =" ; he 
*TCOP C:XS= XS 1! AUA(O) 
J (LEN (X$) <N) :LOCe : - 


bis 
io 
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Goro destinaticn 
@ any text 


Fach of these commands can be enabled or 
disabled by the PROBLEM statement. IF enabled 
then every time an ACCEPT statement is executed 
PCc/PILOT automatically checks the student 
response for the presence of the command. A 
coro command is signified by the word gotc 
Followed by a destination. It causes an 
immediate jump to that destination. It is 
useful during program testing to jump around in 
a program and check out various sections. If 
can also be used to allow the student to move 
around in the program. The ESCAPE command is 
signified by a response which begins with the 
"ea" character. + causes an effect equivalent 
to the statement U:SYSX . That is, a subroutine 
named SYSX is called. It is up to the program 
author to insure that label SYS& exists. ThA 


{ 


SYSK routine could be used to record comme! 
from the student as shown in the first exam 
below. It could also be used to allow 
display of a menu or glossery on demand. 
cysx routine should end with an END statemen 
If no argument is given on the END then a retur 
is made to the statement after the ACCEPT. The 
first example below returns to re-execute the 
ACCEPT. Note also that cince the END can 
specify a label, it is not necessary to return 
at all, as shown in the second example. 
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*SYSX E:SYSK2 
*SYSX2.. T: GOING TO MAIN MENU. 
J: MENU 


*SYSKX R: DISPLAY GLOSSARY SCREEN 


TS:P3 

R: WAIT 30 SECS CR UNTIL KEY HIT 
Ww: 300 

R: FUT BACK CRIGINAL SCREEN 

TS: PO 

R: RETURN AND REACCEST 

E: @€A 


also: PROBLEM, ACCEPT, USE, END 


{J} 
pea 
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PC/PILOT handles programming errors in 
forgiving way. If an error is encountered th 
Statement in error is displayed on the screer 
Before it is a message which denotes what th 
problem is. Execution then pauses. The use 
can push CFRL-C to stcp the pregram or can pus 
any other key to ignore the error and continu 
executicn with the next statement. If it is a 
all possible tc go on, and it usually is 
PC/PILOT will continue with the program. Th 
follewing error ccdes are used by EC/PIICT. 


disk - i/o error in prcgran file 
exD - invalid or missing expres 
file - no file ccen or disk i 
label - missing destinaticn 
link —- program £i 

lspace - tco many labeis in cne weoared modcul 
mode —- graphics Gone when not in moded or 

ccen - can not ccen disk file 

coccce - invalid co code or modifiers 

peren - missing parenthesis 

quote —- missing ctiosdray quote 

recim - attempt to dimension a string or array 

wnich is already dimens icned 
Ssrace - cut of strinc scratch ped scace 
subscript— isto big for the array or current 
length of the strinc 

syntax - statement has bad command or cceratecr 
uspece — use call level is tco dees ( over 5 ) 

Var - missing variable name 

Vsvece —- too many variables in use 


xspece - mo more memory for arrays or stings 


ir) 


EZ EDITOR 


EZ is a simple screen or tented editor. To use 
it in 80 colum mode enter 


X:EZ y:name.PIL 
or to use it in 40 colum mde 
X:EZ40 y:iname.PIL 


where x: and y: are the normal optional path or 
drive designations. If the named file dees not 
exist it is created. _If it does exist, it 1s 
read in and displayed on the screen. Tf ans 
line is too long to fit across the screen (i.e. 
- over 79 or over 39), it is split into twe 
lines by inserting a new-line sequence. Upor 
exit a backup copy of the file is retained as 
name.BAK. Once.in EZ the scseen is a window o 
. The various cursor and furctia 
keys are used to move arcuns in the text and t 
add, change or delete.text. If the entire tex 
ra in memory then you can tell E 
Ss out to the result file an 

c 


to work on. When SAA % a6 


what you see on the screen is what you cet 
the text file. The following summary shows ti 
varicus Reynoatd functions you can use. 


UP, DOWN, RIGAT move the cursor one spece ir 
and LEFT arrows any specified direction. 
TAS move the cursor to the nex” 


column which is a multipl: 
of 10. 





HOME move to the first text 
currently in memory. A 

END move to the last text. 
Currently in memory. ; 

PG UP move uD fe, on: 
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